home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Best of Shareware
/
Best of PC Windows Shareware 1.0 - Wayzata Technology (7111) (1993).iso
/
mac
/
DOS
/
UTILITY
/
PATH_12
/
PATH-MAN.DOC
< prev
next >
Wrap
Text File
|
1992-07-31
|
34KB
|
919 lines
Ç ────────────────────────────────────────────
Ç ┼┐════════════════════════════════════════════
╔╬╗ ┴
╨║╨ ┐
╔╩╗ ┴
╨ ╨
▒▒▒▒▒▒▒▒▄ ▒▒▄ ▒▒▒▒▒▒▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄
▒▒█▀▀▀▒▒█ ▒▒▒▒▄ ▒▒█▀▀▀ ▒▒█ ▒▒█ ▒▒▒▄ ▒▒▒█ ▒▒▒▒▄ ▒▒▒▄ ▒▒█
▒▒▒▒▒▒▒▒█ ▒▒█▀▒▒▄ ▒▒█ ▒▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▄ ▒▒▒█ ▒▒▒█ ▒▒█▀▒▒▄ ▒▒█▒▒▄▒▒█
▒▒█▀▀▀▀▀▀ ▒▒▒▒▒▒█ ▒▒█ ▒▒█▀▀▀▒▒█ ▀▀▀▀▀▀ ▒▒█▒▒▄▒▒█ ▒▒▒▒▒▒█ ▒▒█ ▀▒▒▒█
▒▒█ ▒▒█▀▀▀▒▒▄ ▒▒█ ▒▒█ ▒▒█ ▒▒█▒▒█▒▒█ ▒▒█▀▀▀▒▒▄ ▒▒█ ▒▒█
▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀
Welcome to PATH-MAN, a utility program to determine if a file is located on a
PATH directory!
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
U S E R M A N U A L
Version 1.1
Release May 24, 1991
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
Copyright 1991-1992 by Micrometric.
All rights reserved.
PATH-MAN is distributed as SHAREWARE and, as such, may be copied and shared on a
private non-commercial basis with others in its unmodified form. Liability is
limited to replacing the software for registered users. There is no liability
for any damage or loss caused by this software, directly or indirectly.
┌────────────────────────────────────────────────┐
│ ┌───────┐ │█
│ ┌────┴──┐ │ (R) │█
│ ──│ │O │─────────────────── │█
│ │ ┌────┴╨─┐ │ Association of │█
│ │ │ │─┘ Shareware │█
│ └──│ O │ Professionals │█
│ ─────│ ║ │───────────────────── │█
│ └───╨───┘ MEMBER │█
└────────────────────────────────────────────────┘█
██████████████████████████████████████████████████
If you have problems with this program, or want to send comments, manual correc-
tions, or enhancement suggestions, you may call or mail them to:
Micrometric
98 Dade Avenue
Sarasota, FLorida 34232-1609 USA
Tech Support . . (813) 377-2515
FAX . . . . . . . (813) 377-2091
Support BBS . . . (813) 371-2490
The Micrometric Software Support BBS provides availability and technical support
for the Micrometric ■■■■-MAN series of shareware programs. First time callers
have access to the board and can leave messages or download replies/current
shareware releases. Registered users may also download the latest Beta test
software releases, when available.
Additionally, you can send routed E-Mail via the RIME(tm) network to David
Groome at the ->ACTION node in the ASP, Laser, Batch, Common, or Shareware con-
ferences. I also check CompuServe (71631,744), but only on an infrequent basis.
PKZIP, PKUNZIP and PKSFX are trademarks of PKWARE, Inc.
MS-DOS is a registered trademark of the Microsoft Corporation.
IBM PC, XT, AT and PC-DOS are registered trademarks of the IBM Corporation.
2
TABLE OF CONTENTS
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Major Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Manual Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Page layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Brackets and parentheses . . . . . . . . . . . . . . . . . . . . . . 5
Computer key conventions . . . . . . . . . . . . . . . . . . . . . . 5
Action steps . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
■■■■-MAN programs . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Shareware distributed documentation manual . . . . . . . . . . . . . 6
Shareware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
INSTALLING THE SYSTEM . . . . . . . . . . . . . . . . . . . . . . . . . . 9
From a Diskette Vendor . . . . . . . . . . . . . . . . . . . . . . . . . 9
From a BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Registered Version . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
RUNNING PATH-MAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
FileName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
ERRORLEVEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Shareware message . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3
TABLE OF CONTENTS PATH-MAN Version 1.1
4
INTRODUCTION
PATH-MAN is a utility that searches the directory path elements of the PATH
statement for a given file. The search file name may include DOS wildcard char-
acters. The ERRORLEVEL variable is set, based on the results of this search, to
allow more user friendly batch files - a graceful exit can be made when needed
data files or programs are missing. Optionally, the path element on which the
search file is located may be displayed.
Major Features
* Searches the directory path elements of the current PATH statement for a
given file.
* Sets the ERRORLEVEL variable, based on the results of this search, to allow
more user friendly batch files - a graceful exit can be made when needed data
files or programs are missing.
* Optional display of the first path element on which the search file name is
found.
* DOS wildcard characters of * and ? may be used in the search file name.
* Small size and fast operation.
System Requirements
PATH-MAN will run on an IBM PC, XT, AT or true compatibles. It has been tested
with PC-DOS/MS-DOS operating systems, version 3.0 through version 5.0.
Manual Format
This manual is divided into several introductory chapters followed by chapters
for operating PATH-MAN. The format of these chapters and the information pre-
sented therein has been standardized using the following conventions.
Page layout - Each page has a header detailing the chapter and the program ver-
sion covered. A footer displays the manual page number.
Brackets and parentheses - Brackets, [...], are used in the manual and in the
help screens to specify what should be entered in response to the current
prompt. If a character string is to be entered, the type of character is noted,
such as ALPHA, NUMERIC, ANY, etc. Parentheses, (..), are used for comments.
Computer key conventions - Keys specified in the manual text that are not in
entry brackets are shown as reversed, such as ESCAPE . All key references are
in capital letters for clarity.
Action steps - Some procedures may require selection from a menu of options,
inputting data or following a sequence of steps. Most manual sections will first
give an overview of the function or task under discussion and then detail the
various action operating procedures. In order to make this manual easier to use
a symbol, -> , marks the beginning of each of these action operating procedures.
■■■■-MAN programs - The general group of shareware programs by Micrometric is
referred to by the name ■■■■-MAN. It may also be used in reference to a specific
program in that group.
5
INTRODUCTION PATH-MAN Version 1.1
Shareware distributed documentation manual - The documentation file included on
the shareware distribution diskette contains the same information as the printed
and bound manual, supplied as part of registration, with two exceptions, the
result of the word processor, formatting, and printer used. The first is that
all of the control display characters (ASCII 1-31) and the reverse print key-
board codes are NOT shown properly. Finally, bolding, underlining, and special
symbols are NOT present.
Shareware
PATH-MAN is being distributed as SHAREWARE. The SHAREWARE concept allows users
to examine a program on a trial basis, at no (or minimal) charge, before pur-
chasing it. In addition, by decreasing marketing costs, professional quality
software may be distributed for a fraction of the cost of a comparable commer-
cial product. Regardless of whether you register the program, please help dis-
tribute PATH-MAN by sharing unmodified copies of it and its files with others.
You are hereby granted the right to use the PATH-MAN program for a thirty (30)
day evaluation period. If you find PATH-MAN of value, and continue to use it
after this evaluation period, YOU MUST REGISTER YOUR PROGRAM USE. This will
provide you with:
* A 7" x 8 1/2" printed and bound manual.
* PATH-MAN phone or mail support for one year.
* Notification of the next PATH-MAN release.
* Ability to suppress the shareware registration reminder message displayed
at the end of the program.
* An installation/update/registration branding program.
* Sincere thanks for your support of the SHAREWARE concept.
A Single System Program Registration entitles the user to unlimited use of the
PATH-MAN program on a single computer.
A Site License Program Registration entitles the user to unlimited use of the
PATH-MAN program on all computers, including networks, at a single corporate
location.
Program Registration, Single System . . . . . $15.
Includes latest version diskette and manual
Program Registration, Site License . . . . $150.
Includes latest version diskette and manual
Latest Version Diskette only . . . . . . . . $10.
Shipping - Surface (for outside of USA/Canada only)$5.
Shipping - Air (for outside of USA/Canada only) $10.
COD and credit card orders, add 5%.
Florida residents, add 7% sales tax.
6
PATH-MAN Version 1.1 INTRODUCTION
ADDRESS: Micrometric
98 Dade Avenue
Sarasota, FLorida 34232-1609 USA
PHONE: Tech Support . . (813) 377-2515
FAX . . . . . . . (813) 377-2091
Support BBS . . . (813) 371-2490
Order Line . . . (800) 929-0184
For ease in program registration, a registration order form is included with the
distribution files.
This program is produced by a member of the Association of Shareware Profession-
als (ASP). ASP wants to make sure that the shareware principal works for you. If
you are unable to resolve a shareware-related problem with an ASP member by
contacting the member directly, ASP may be able to help. The ASP Ombudsman can
help you resolve a dispute or problem with an ASP member, but does not provide
technical support for members' products. Please write to the ASP Ombudsman at
545 Grover Road, Muskegon, MI 49442-9427, send a CompuServe message via easyplex
to ASP Ombudsman 70007,3536, or by FAX to the ASP FAX number: (616) 788-2765. In
communications with the Ombudsman please include a telephone number and/or FAX
if available.
7
INTRODUCTION PATH-MAN Version 1.1
8
INSTALLING THE SYSTEM
From a Diskette Vendor
If the PATH-MAN program has been obtained from a diskette vendor, you should
follow any of their instruction on unpacking/installing the programs (if indeed
they have separate instructions.) The program, and its files, is normally sup-
plied as a self extracting file whose name is "PATH@xxx.EXE" (xxx is the ver-
sion, such as "PATH@100").
This file should first be copied to a directory on your hard disk. This direc-
tory may be a new one, such as one named "PATH", and created specifically for
PATH-MAN, or a current one, such as "UTILITY", that has other programs/files.
For information on creating a separate directory, see your DOS manual.
NOTE FOR BEST OPERATION, ALL REQUIRED PATH-MAN FILES *SHOULD* BE PLACED ON
PATH REFERENCED SUBDIRECTORIES!
Once the file is copied to the desired hard disk directory, at the DOS prompt
change to this drive directory, and then type the EXE file name (such as
"PATH@100") and press ENTER . This will unpack all of the PATH-MAN files.
From a BBS
If the PATH-MAN file was downloaded from a Bulletin Board, it should first be
copied to a directory as defined above, and then unpacked, using whatever pro-
gram is specified by the Bulletin Board. It is normally distributed with a name
of "PATH@vvv.ZIP" (vvv is the version) or "PATHMN.ZIP".
Registered Version
Registered users should use the program "INSTALL", that is supplied upon regis-
tration. This program will create a registration file which will, in turn, sup-
press the shareware registration reminders.
-> To install PATH-MAN on your hard disk, follow the steps detailed below:
1. Place the PATH-MAN distribution diskette in your floppy diskette drive.
2. At the DOS prompt, change to the drive in which the distribution diskette
is located. For example, if the diskette was placed in drive A, type A
: and press ENTER .
3. Type I N S T A L L and press ENTER . The installation pro-
gram will then be loaded, and its display should be as shown below.
9
INSTALLING THE SYSTEM PATH-MAN Version 1.1
╒═╡ INSTallation MANagement Program/One System Started at═>07-31-92 03:00 ╞═╕
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│
│░ ░░▄ ░░▄ ░░▄░░░░░░░░▄░░░░░░░░▄ ░░▄ ░░▄ ░░▄ ░░▄ ░░▄░│
│░ Ç═ ░░█ ░░░▄ ░░█░░█▀▀▀▀▀▀ ▀▀░░█▀▀▀ ░░▄ ░░░▄ ░░░█ ░░░░▄ ░░░▄ ░░█░│
│░ ┌┼┐ ░░█ ░░█░░▄░░█░░░░░░░░▄ ░░█ ░░░█ ░░░█ ░░░█ ░░█▀░░▄ ░░█░░▄░░█░│
│░ ┌┴┐ ░░█ ░░█ ▀░░░█ ▀▀▀▀▀░░█ ░░█ ░░█ ░░█░░▄░░█ ░░░░░░█ ░░█ ▀░░░█░│
│░═┴═┴═░░█ ░░█ ░░█░░░░░░░░█ ░░█ ░░░░▄ ░░█░░█░░█░░█▀▀▀░░▄░░█ ░░█░│
│░ ▀▀ ▀▀ ▀▀ ▀▀▀▀▀▀▀▀ ▀▀ ▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀░│
╘╡ INSTALL/1 Version 3.00 Copyright 1990-92 Micrometric, All Rights Reserved ╞╛
F1>Help│ESC>Exit│ENTER/[char]>Select│ HomeEnd│
NOTE Context sensitive help is available from this point in the installa-
tion program on, by pressing the F1 key.
4. If a color video card is detected, the following prompt will be displayed.
┌──────────────────────────────────────┐
│ ╔═╡ Color Monitor Card Detected ╞═╗ │
│ ║ Use the color display ║█ │
│ ║ Force a monochrome display ║█ │
│ ╚═════════════════════════════════╝█ │
│ ███████████████████████████████████ │
└──────────────────────────────────────┘
-> If your system has a color monitor, press U .
-> If your system has a monochrome or LCD display, press F .
5. A selection list of all path referenced directories is next displayed.
NOTE FOR BEST OPERATION, ALL REQUIRED PATH-MAN FILES *SHOULD* BE PLACED
ON PATH REFERENCED SUBDIRECTORIES!
10
PATH-MAN Version 1.1 INSTALLING THE SYSTEM
┌────────────────────────────────────────────┐
│ ┌─┤ Select the INSTALLATION DIRECTORY ├─┐ │
│ │ C:\BAT │█ │
│ │ C:\DOS-500 │█ │
│ │ C:\UTILITY │█ │
│ │ C:\ZIP │█ │
│ │ C:\ │█ │
│ │ User Defined Drive-Directory Path │█ │
│ └───────────────────────────────────────┘█ │
│ █████████████████████████████████████████ │
└────────────────────────────────────────────┘
-> To cancel the installation program at this point, press ESCAPE .
-> To select one of the path referenced directories on which to install
PATH-MAN, move the highlight bar to the desired one and press ENTER .
-> To specify a non-path referenced directory on which to install
PATH-MAN, press U and then press ENTER . A data entry window for the
installation path will then be displayed, as shown below (with an exam-
ple path already entered). Enter the desired drive and directory path
on which to install PATH-MAN, using the control keys described on the
bottom help line.
┌────────────────────────────────────────────────────────────────────────┐
│ ┌─┤ Enter Path ├────────────────────────────────────────────────────┐ │
│ │ C:\PATH.......................................................... │█ │
│ └───────────────────────────────────────────────────────────────────┘█ │
│ █████████████████████████████████████████████████████████████████████ │
└────────────────────────────────────────────────────────────────────────┘
-> To cancel defining the path, press ESCAPE . The program will return
to directory selection.
-> To accept the path as entered and edited, press ENTER . If the
specified directory does not currently exist, the following message
will be displayed.
┌────────────────────────────────────────────────────────────────────┐
│ ┌─┤ MESSAGE ├───────────────────────────────────────────────────┐ │
│ │ The drive-directory path as entered DOES NOT currently exist. │█ │
│ │ This directory WILL NOW BE created. │█ │
│ └───────────────────────────────────────────────────────────────┘█ │
│ █████████████████████████████████████████████████████████████████ │
└────────────────────────────────────────────────────────────────────┘
-> To cancel creation of this directory, press ESCAPE .
-> To create the specified directory, press ENTER . If the speci-
fied drive is invalid or the requested installation directory's
parent does not exist, an error message will be displayed. Press
any key, and then re-edit the installation path.
6. If more than one system is available for installation, a SYSTEM TO INSTALL
selection menu will be displayed, as shown below.
11
INSTALLING THE SYSTEM PATH-MAN Version 1.1
┌─────────────────────────────────────────────────────────────────────┐
│ ╔═══╡ Select the SYSTEM TO INSTALL ╞═════════════════════════════╗ │
│ ║ ENVI-MAN Environment data summary, environ. space remaining ║█ │
│ ║ FILE-MAN Menu driven DOS file manager, directory tree ║█ │
│ ║ LASR-MAN Print text files on a laser printer, 36 print styles ║█ │
│ ║ MENU-MAN Display custom user selection menus from batch files ║█ │
│ ║ PATH-MAN Determines if a file is on a PATH directory ║█ │
│ ╚════════════════════════════════════════════════════════════════╝█ │
│ ██████████████████████████████████████████████████████████████████ │
└─────────────────────────────────────────────────────────────────────┘
-> To terminate the installation program at this point, press ESCAPE .
-> To select the SYSTEM TO INSTALL, press its highlighted letter or move
the highlight bar to in with the arrow keys and press ENTER .
7. A list of all PATH-MAN files is next displayed, along with an INSTALLATION
FUNCTION menu. The normal sequence of operations is to first "Install" the
PATH-MAN program and files, and then "Brand" the system with your name and
serial number.
┌─────────────────────────────────────────────────────────────┐
│ ╒═╡ Select the INSTALLATION FUNCTION ╞═══════════════════╕ │
│ │ Install system Brand system eXit │█ │
│ ╘════════════════════════════════════════════════════════╛█ │
│ ██████████████████████████████████████████████████████████ │
└─────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────┐
│╒═╡ File Name Status Hard Disk Path/File Description PATH-MAN FILES ╞═╕ │
││ System═>PATH-MAN Determines if a file is on a PATH directory │█│
││ PATH-MAN.COM PROCESS Utility program │█│
││ YYYY.YYY PROCESS Other files │█│
│╘═╡ INSTALLATION PATH═>C:\PATH ╞════════════════════════════════════════════╛█│
│ █████████████████████████████████████████████████████████████████████████████│
└──────────────────────────────────────────────────────────────────────────────┘
-> To install PATH-MAN on the hard disk, insure that the highlight bar is
on the "INSTALL SYSTEM" FUNCTION and press ENTER . Each of the file(s)
will be copied to the selected installation drive-directory.
NOTE A happy face symbol after any of the system's file names de-
notes that this file is already on the hard disk. During in-
stallation it will be replaced, on the directory where it
currently resides, not the INSTALLATION DRIVE-DIRECTORY PATH.
When all files have been copied to the hard disk, a copy complete mes-
sage is displayed.
12
PATH-MAN Version 1.1 INSTALLING THE SYSTEM
┌───────────────────────────────────────────────────────────────┐
│ ┌─┤ MESSAGE ├──────────────────────────────────────────────┐ │
│ │ FILE COPY COMPLETED. │█ │
│ │ All of the required BOOK-IT! files are on the hard disk. │█ │
│ │ ═══> BOOK-IT! IS READY TO RUN. <═══ │█ │
│ └──────────────────────────────────────────────────────────┘█ │
│ ████████████████████████████████████████████████████████████ │
└───────────────────────────────────────────────────────────────┘
-> To cancel the installation at this point, press ESCAPE .
-> To continue with the installation, press any other key. The high-
light bar will then be on the "BRAND SYSTEM" FUNCTION.
8. -> To brand the system with your name and serial number, move the high-
light bar to the "BRAND SYSTEM" FUNCTION and press ENTER . A REGISTRA-
TION INFORMATION data entry window will be displayed, as shown below,
with sample data already entered.
NOTE This step is REQUIRED for PATH-MAN to be registered. Also, if
you move the PATH-MAN files to another drive-directory you
will need to "BRAND" the system again.
Enter your company and/or your name, and then the system registration
number. Your registration number is located on the back of the front
cover of this manual.
┌──────────────────────────────────────────┐
│ ┌─┤ REGISTRATION INFORMATION ├────────┐ │
│ │ Name ABC COMPANY, George Jones │█ │
│ │ Registration number 12345678 │█ │
│ └─────────────────────────────────────┘█ │
│ ███████████████████████████████████████ │
└──────────────────────────────────────────┘
-> To accept either the name or registration number after entry and
editing, press ENTER . A message will be displayed after the regis-
tration number is entered. It's contents are dependent on whether
the registration number is valid. Both messages are shown below.
┌───────────────────────────────────────────────┐
│ ┌─┤ MESSAGE ├──────────────────────────────┐ │
│ │ BOOK-IT! serial number entered is VALID. │█ │
│ └──────────────────────────────────────────┘█ │
│ ████████████████████████████████████████████ │
└───────────────────────────────────────────────┘
┌─────────────────────────────────────────────────┐
│ ┌─┤ MESSAGE ├────────────────────────────────┐ │
│ │ BOOK-IT! serial number entered is INVALID! │█ │
│ │ Please try again. │█ │
│ └────────────────────────────────────────────┘█ │
│ ██████████████████████████████████████████████ │
└─────────────────────────────────────────────────┘
13
INSTALLING THE SYSTEM PATH-MAN Version 1.1
-> To continue with the installation program, press any key. If the
registration number was valid, the "EXIT" option is highlighted.
If it was invalid, select the "BRAND SYSTEM" option again.
9. -> To exit from the installation program, move the highlight bar to the
"EXIT" FUNCTION and press ENTER . If the system has been properly
branded, the program will exit, and PATH-MAN is ready for use. If the
system has not been branded, an error message is displayed, as shown
below.
┌─────────────────────────────────────────────────────────────────┐
│ ┌─┤ MESSAGE ├────────────────────────────────────────────────┐ │
│ │ This system has not been 'BRANDED'. │█ │
│ │ In order to be registered, it must first be 'BRANDED'! │█ │
│ │ To exit without BRANDING, press ESCAPE. │█ │
│ │ To continue with the INSTALL program, press any other key. │█ │
│ └────────────────────────────────────────────────────────────┘█ │
│ ██████████████████████████████████████████████████████████████ │
└─────────────────────────────────────────────────────────────────┘
14
RUNNING PATH-MAN
The syntax to execute the PATH-MAN utility program is:
PATH-MAN FileName[option]
A space MUST be present after the program name and before the FileName parame-
ter. A space MUST NOT be placed between the FileName and the option, if it is
present.
FileName
The file name to be found follows the standard DOS conventions, with a maximum
of eight characters for the file name and three characters for the extension
with a '.' separator. The DOS wildcard characters of ? and * may be used. If no
extension is specified, the match will be on name with all extensions matching.
Option
If the FileName is followed by a '?' character, the program will display the
search results. If a matching file is found, a message with the path of the
FIRST matching file is displayed. If no matching file is found, a message with
the FileName searched for is displayed. In both cases the ERRORLEVEL value is
also displayed.
NOTE: A '?' at the end of the FileName[option] is always treated as an option
rather that a DOS wildcard '?'.
Operation
PATH-MAN searches the path directory elements referenced in the PATH statement
in the order in which they appear. For example, with the PATH statement -
PATH=[D1:Path1][D2:Path2][...]
the path element D1:Path1 is searched first followed by D2:Path2. If a match is
found, the search is terminated and the ERRORLEVEL variable is set.
ERRORLEVEL
The ERRORLEVEL variable is set based on the results of the search for FileName.
If a match to FileName is found on any of the path directory elements of the
PATH statement, ERRORLEVEL is set to the ordinal number of the Dx:Pathx path on
which the file is found. This number may range from one to the number of ele-
ments in the PATH statement.
If PATH-MAN is not present or FileName is NOT found on any of the path directory
elements of the PATH statement, ERRORLEVEL is set to 0.
NOTE: PATH-MAN's use of the ERRORLEVEL variable is the inverse of many (if not
most) programs: a zero ERRORLEVEL is bad and a non-zero value is good. The
main reasons for this is to assure that PATH-MAN.COM is present and allow
the path element number to be passed to the batch file.
15
RUNNING PATH-MAN PATH-MAN Version 1.1
Shareware message
A shareware message may be randomly displayed at the end of PATH-MAN. Pressing
any key will exit the program. By registering your use of PATH-MAN, you will be
able to use the registration serial number to suppress this shareware message
display.
Examples
For the purpose of these examples, assume that only files PATH-MAN.COM, XYZ.COM
and ABC.COM are on PATH directories.
Batch file code segment examples -
File found -
...
PATH-MAN ABC.COM
[errorlevel set to 1]
IF ERRORLEVEL 1 GOTO RUN
ECHO PROGRAM ABC.COM IS MISSING!
GOTO EXIT
...
:RUN
[batch file branches to this point]
...
:EXIT
File not found -
...
PATH-MAN CBA.COM
[errorlevel set to 0]
IF ERRORLEVEL 1 GOTO RUN
[batch file continues here]
ECHO PROGRAM CBA.COM IS MISSING!
GOTO EXIT
...
:EXIT
Command line code examples -
For - PATH-MAN XYZ.COM?
a display of - Found═>[path]\XYZ.COM
ERRORLEVEL═>1
For - PATH-MAN XYZ.*?
a display of - Found═>[path]\XYZ.COM
ERRORLEVEL═>1
For - PATH-MAN XYZ.A*?
a display of - Not Found═>XYZ.A*
ERRORLEVEL═>1
16